Good Things To Know About Lisa 


June 12 , 1984 

By Conger Jeirigan 
Lisa Phone Si|)port 



Table of Contents 


Monitors 1 

Conrac 

Eleclrohome 


DWP 1 

Settings 
Error Numbers 
Changing the Ribbon 
Changing the Print Wheel 


Image Writer 2 

Settings 
Enor 1222 

Enor Numbers 2 

Meanings 


DMP 3 

Error numbers 
Error 1222 

Fincftng Phantom Connections 
Landscape 
Printer Buffer 

Memory Enors 

LisaTerminal 

Notes 

VTlOOMode 
Memory Management 
Dialing up another Lisa 
Copy4)aste from write 
Copy/t^ste from Calc 
Hang when line is busy 
Apple Modem cables 

Setting the baud rate for an Apple Modem 
Protocol Converter 
Cluster Controller 
VT52Enata 
Keyboard 
CR-LF 

Clear Lines Off Top 
Capacity 

Lisa Write 7 

Page Marks 
Letterhead 
Double underline 
Tabs 

Formatting 
Printing on ri^t 


cr lA 



Printing underlines 
Blank pages 
Preview pages 

LlsaCalc 9 

Capacity 

Management Techniques 
Cell Selection 
Time to save and put away 
CutSc Paste 

Cut & Paste with formulas 
Find Missing value 
Formulas 

Cell Coordinate Entry 
Calculation 
Error Results 
Precision Problems 
Lookup 

How to check for blank cell 

htewvs,Used 

Using dates In formulas 

More /\bout Dates 

Net Present Value 

Sorting 

LlsaDraw 15 

Pasting 
Centered Text 
Cut &Paste from Write 
Even Spacing 
Shadlr^ 

Enor 3001 or 3007 
Shrinking and Stretching 
Pcsting From Graph 
Printing landscape 
Printing 
2.0 Stationary 
Complex drawings 
Capacity 

LlsaList 14 

Sorting 
Data Formats 
Zip codes 
2.0 Conversion 
Capacity 

LlsaGraph 15 

Copy from Calc 
2 decomal pieces 
Customize X axis 
Changing Shades 
i^re gr^)hs on a 



Capacity 


LlsaProject 16 

Connecting tasks 
Drawing size 
Resource chart 
Dates 
Resources 
Scheduled dates 
TABS 

Extra pages 

Start at beginning of calendar 
Capacity 

workShc^ 17 

Eliminating LlsaBug 
Program termination 


Pascal 19 

Using serial ports 
Creating shells 

Mounting and reacftng diskettes 
Units 

Lisa Application File structures 

Numerics 

Pictures 

Textslze 

Printing Graphics 

Typestyles 

Qulckdr^ samples 


Cobol 22 

Development Tools 
Printing 


Basic 22 

Available memory 
Printing 

Qulckfwrt 22 

Toolkit 22 

Disks 25 

Diskette is Deteriorating Message 
Profile-Memory Loss 
Boot PRCX^ versions 

Mlsceiianeojs 25 

Page Numbering 
Scr^Dunnps 
SpontanecHJs Reset 
Dialog Boxes 
Empty Folders 


Accessirg the Envlroimaits window 



Magic Lisa Keystrokes 
Copyprotection 
Which Tools are Protected 
Spares Kit-Software 
External Sony 

Transfer of wananty information 


Lisa2 26 

1/2 Megabyte 
Copying OS 1-4 Diskettes 


Bsckup 27 

When to Backup 
Full Backup 
Incremental Backup 
Duplicating 
Backup Problems 


Lisa 2 Upgrade 28 

Upgrade Kit Problems 
Troitoleshootlng 

LlsaGulde 30 

Starting LlsaGiUicte 
Boot Problems 
Installing as a ^11 

MacWorks 30 

Third Party Software 31 

To be a developer 
Unix Software 

Service Mode 31 

Newsletters 32 

Anti- Theft Device 33 

Repair 33 

WhentoRef^ir 
Problems 
Minor Repairs 

Pascal E)«frples 34 

Errors 44 



Good Stuff to Know About Ldsa 


Monitors: 

Oonrac; 


wnai to order: 


Bectrohome: 


What to order; 


Conrac Corp, 

600 N. Rlmsdale Ave. 

Covina, CA 91722 
(215) 966-3511 

23" Blad< and While 

cabinet Model SNA-23/C 

27.7 KHz horizontal line rate 

60 Hiz vertical field rate 

under scan adjusted so that 4 comers are visible 

Modified for fast vertical retrace 

20 MHZ video amplifier 

Electrohome (U.SA.) Limited 
250 Wales Ave. 

Tonawanda, New YoiK 14150 
(716) 694-3332 

EDP-57 Monochrome Projection monitor 

Projects up to 15* diagonal screen 

standard Is green Pi phosphor^ Other phosphors available on 

order. 


switch 1; 11100111 
Switch 2: 10010000 
Numbered 8 to 1; 1 - On, 0 - Off 

Space Parity 
Local 

EXT/ACK Handshaking 
9600 Baud 
Paper out on 

Duplex 6 Auto CR/LF off 
B1 directional print on 
Ascii Standard 

You must also use a "Modem Eliminator", 590-0029-00, in series 
with the interface cable. 


Error Numbers: 

Enor 

Meanina 


1199 

DMP set in Format for the Printer 


646 

No modem eliminator cable or not set properly 
in Preferences 


3056 

Generic printer problem - check cables, 
paper, ribbon, etc. 

Cha^f^ the Rlbtm 

Take a look at page 7 In the Daisy Wheel Printer manual. 

Changing the Print Wheel: 



Take a look at p^ 4 in the Daisy Wheel Printer manual. 


DWP: 

Settings; 
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Imagewriten 


Error 1222: 


Enor Numbers 


Mear^lngs: 


Switch 1: 00100000 
Switch 2: 0011 

Numbered 8 to 1; 1 - closecL 0 - open 

You must also use a “Modem Eliminator"^ 590-0029-00, in series 
with the interface cable. 

This enor means that Preferences thinks that there is arother 
DMP connected to the expansion ports. This error frequently 
occurs when the system is reconfigured after previously having a 
parallel DMP on the system. The expansion card was taken out 
without resetting Preferences. See the DMP section for a more 
complete descriptioa 


The most common error numbers are described in the Owner's 
Guide starting in Appendix 3 on page 17. There are also more 
error messages on starting on page 125 in Appendix 6. in the Lisa 
2 Owner's Guide the error messages are in Appendix 3, beginning 
on page G59, and on pages C49-C58 These error messages are 
quite general and are mainly used to point to the general 
direction in which the problem lies. 

Other more detailed errors are located in the System software 
Manual and are described below. 

There are three types of error numbers that can be 
displayed: 

1) A single number: xxx 

This can be found in the System Software Manual. This 
number usually means that the error occured in code located 
in the Filer. The only exception to this rule is if the number 
starts with a 6 (l.e. 608), then the enor is related to printing. 

2) Two numbers; xxx/xxx 

The first number usually refers to a location in the lower 
levels of the Operating Systan. The second is usually the 
enor code. However these are sometimes reversed so it is 
best to look up both in the System Software hfenual. 

3) Three numbers: xxx/yyy/zzz 

XXX: Indicates the System program that died. 

yyy: The enor number indicating why it died 

zzz: The actual code address where die error occured. 

If you get one of these three number codes and the first one 
happens to be a 1033, the second number can give you an 
indication of the problem: 
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Error 

Mil 1 

Solution 

7 

I/O problem 

reinstall software 

10 

Parity Error 

replace memory 

21, 22 

program error 

none 

26, 27 

bad source, bad memory 


Here's some other errors that occur during startup. These 
error numbers are in the 10700 range and are usually 
accompanied by a crossed out Lisa Following Is a list of 
these errors; 

Error Meaning 

10725 Damaged file system or file contents 

10726 Profile error^ problem with boot tracks 

10727 Memory Error 

10728 Boot file is missing or damaged 

10729 

10730 

10731 

10732 

10735 

10736 

10737 

If one of the above enors is encountered do the following: 

1. Reinstall the startup software - in 1.0 Owner's Guide pg. D-50 

2. If step 1 doesn't work then repair and try again - in 1.0 Owner's 
Guide pg.D-53 (Lisa 2 Owner's Guide pg.C24) 

3. If step 2 doesn't work then you may have bad Office System 
disks. Get another set and try st^ 1 and 2 agala 

4. If nothing has worked, then you need to reload the software. 
Take the Profile over to another Lisa and save any flies If you can. 
Then reload all of the software onto your Profile - pg. D-32 In the 
Owner's Guide. 


Dl^. 

Error Nuntoers: 


Error Meaning 

0 Not configured in Preferences 

1199 2 DMP's configured in Preferences 

1222 More than l DMP in Preferences* 

1885 Profile timeout error 

648 Parallel DMP on serial A or B 

3166 Generic printer problem - cables, 

paper, ribbon, eta 
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Error 1222: 


If you originally had a dot matrix printer configured in 
Preferences for a parallel expansion card^ then disconnected the 
printer to move the card to a different slot^ or remove it to 
connect an imagewriter, but didn’t set the device connections in 
Preferences to "No Device" before moving (or removing), this 
results in a "phantom" device connection. This means that when 
you try to prints the Lisa thinks there is still a card and printer 
there and will try to print there first giving an error 1222. When 
you open Preferences to check the settings, only slots which have 
cards in them at that time are listed; the moved or removed card 
is not in the list, and so you can’t change the setting or verify that 
there is such a setting. We call this a phantom device connectioa 

Finding Phantom Connections: 

There is an easy way to determine if there is a phantom device 
connectioa Open any document; pull down File/Print and choose 
Format for Printer; for Print Method and Paper Size, select 
settings which don’t match any printer the user has ever had 
(choosing daisy wheel with 14" x 11" is a good one); at the bottom 
of the dialog box, choose Tell (in Office System 2.0, it’s Ask 
Me); click the OK buttoa A new dialog box: will appear, labeled 
Intended Printer Lhavallahle On 2.0: Intended Printer not in 
Preferences). In the middle of the box will be a list of printers 
next to check boxes. This list of printers will inclucte any 
phantom device connections. 

To fix it you rrHjst install a parallel card in the slot (or slots) that 
has the phantom connection, thar^ open Preferences and set the 
connection to No Device. 

Landscape: Printing landscape, normal resolution (low resolution) will print 

tiny. In 2,0 the default is Low resolutloa 

Printer Buffer. Bill Krause of CMG reports that they have used a 32K model 

in-line parallel printer buffer right out of the box with no 
problems. One of their dealers reported successfully using a 64K 
model. The buffers are from: 

Practical Peripherals, Inc, 

31245 La Baya Drive 
Westlake village, CA 91362 
(213)991-8200 


Memory Errors 


Error Meailno 


10590 
1033/10 
System Haig 


Memory error encountered on startup 
Error encountered in Office System 
Memory error efxxxintered - mouse hang 


Most memory errors are caused by parity errors. They are usually 
awacterized by system hangs where the mouse doesn’t move. 
The problem is that there Isn’t an lixilcation as to which board Is 
falling. It has been asked whether the thorojc^ test on startup or 
LlsaTest will determine which is bcKi. If you run the extended test 
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UsaTerrrtnak 

Notes: 


VTioomode; 


h-temory Management: 


In LlsaTest It may eaten the error, but most people In the field 
don’t have LisaTest So, here are some things to keep in mind: 

Memory Is set up so that the starting address is on Memory board 
2. This meais that the startup software, stacks, etc. are on 
memory board 2. Then data and overflow are on memory board l. 
What this means is that if you experience memory problems on 
startup it is probably memory board 2. If it is ckjrlng the operation 
of the system, it is probdDly memory board 1. 

If the system has only hung once, don’t be concerned until it 
happens again or until you get another memory error. If you get 
error during startup (memory board crossed out) it’s probably 
right Have the indicated board changed. 


1. When doir^ a paste into LisaTerminal to cause a file to be 
transmitted there is no way to abort the paste operatioa 

2. There is rx) way to have LisaTerminal automatically respond to 
a prompt from a host computer (suc^ as an editor prompt for next 
line). 

3. If you have any LisaTerminal problems please send them in 
with enough supporting documentation to reproduce the 
occurrence. 


When attempting to emulate VTlOO operation with LisaTerminal, 
set LISA to “forget" llres that scroll off the screea This mcKle 
^^ars to much more accurately emulate VTlOO functions. The 
LISA can be toggled to "remember" to download data or text, then 
tocKiled back for VTlOO terminal operatioa When toggling back 
aid forth, LISA does not clear that text which has been 
"rememberecT. 

LisaTerminal/LlsaWrite have a problem when atterrptlng to copy 
and paste a large document (20 or more pages) frexn LisaTerminal 
to LisaWrlte. You can real tr« text into the LisaTerminal 
window, cqpy it ento the clipbc^rd, and paste it into Lisawrite, 
but you run the risk of ctem^ing the Lisawrite tool in memory. 
This will give you problems like: messages saying that you have 
too many wirxtows of:^ and vre display is too ccxnplicated; or a 
tecfxiical difficulties message with a 1033/21 error; or other 
bizarre behavior when using Lisawrita 

To avoid problems: copy smaller portions of your Terminal 
document to paste; save the Terminal and Write documents before 
you start my editing in LisaWrlte; at any sign of strange behavior 
in Lisawrite, turn off tr« Lisa arxJ turn back oa When it comes 
back it will be OK 
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Dialing 143 ^tr«r Lisa: To dial up another Lisa, or any other computer you need to have a 

modem that has an ajto answer capability - Hayes Smartmodem 
or an Apple Modem. M^e sure that the compatibility settings are 
the same for both machines and for convenience sake make sure it 
Is set for half duplex to see what you're typing. Then Just dial their 
phone number, their modem will answer and send back the carrier. 
When your modem receives the carrier it will tell you that you're 
connected. Anything that you type or paste will be sent To 
terminate the connection just hang up from the phone menu. 

C5opy /paste from Write: When you paste from Lisawrite to LisaTerminal, Terminal 

expects a carriage return after every line. If the line is too long it 
will truncate it There is a way of getting around this. Copy the 
Write document and paste into an off line Terminal document (one 
that isn't dialed into anything). The Lisa will put in put in carriage 
returns for yoa Copy it again, dial up, then paste. 

There are two problems with this method: The first is that it will 
break in the middle of words if you don't have word wrap set To 
avoid this you can set it to 132 characters. There will be less of a 
chance of brewing in the middle of a word. Or turn on word wrap. 

The second problem is that If you are communicating with the 
Source, they reciuire that the carriage return be within 80 
characters. The problem is that LlsaTermlnal puts that return In 
the 8lst position. Having Terminal set for word wrap will 
alleviate the problem somewhat 

Copy/paste from Calc; To transmit information from LisaCalc In the appropriate format 

(in columns) you need to set tabs in LisaTerminal first, reflecting 
the width of each column to be transmitted, before pasting f ran 
Calc. Otherwise all of the information will be in one column, with 
spaces between eojh entry. A description of how to set tabs in 
Terminal is on pgs, 46-48 in the LisaTerminal manual. 

Hang when line is txisy: If you are using the auto dial feature in LisaTerminal and the line 

is busy or there is no answer, the system appears to hang. Actually 
What Is happening is that LisaTerminal rtas a timeout loop and 
there is noUilng, ^rt of pulling the plug, that will get it out of 
the loop. When the Lisa does finally timeout (in one minute) it will 
behave normally. 

Apple McKlem cables: The Apple modem uses a cable similar to the Mac printer cable. 

Since they do look alike, this cai cause problems when 
communicating with the modem if you have the wrong cable. 

Setting the baud rate for an Apple Modem: 

For the Afple 1200 modem the baud rate is setable, however its 
not very obvious how this is accomplished. The modem will 
determine it's baud rate by vne speed at which information is 
passed to it from the program you're using. This means that if you 
set the Baud rate in LisaTermirval to 300 and then tell the modem 
to auto-dial, it will assume, from the speed of the message it 
receives, that you are going to be comminicating at 300 baxL 
There is one catch: if you change the baud rate in tr« program 
without turning off the modem first, the modem will Ignore you 
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Protocol Converter: 

Cluster Controller: 


VT52 Errata: 

Keytoard: 

CR-LF: 

Clear Screen: 
Capacity: 


Lisawnte: 

Page marks: 

Lettemeact 


Turn off tne modem if you are going to change the baud rate. 

Some have used the AVAT/\R PA-1000 In Line Protocol Converter 
with "remarkable success". The Lisa has evaluated this device 
along with the Irmaline Protocol Converter. They are leaiirvg 
toward the Irmaline option since the installed base is about 10.000 
compared to about 2500 for the avatar. Refer any questions 
about the two devices to Tech comm. 

The Apple Cluster Controller is an Interface between an IBM host 
and the Apple Computer by emulating IBM 3278-2 terminal 
functions and 3287-1 printer functions. 

It comes in two flavors: SNA/SOLC. which emulates an IBM 3274 
or IBM 3276 Control Unlt/Dlsplay Station; and BSC (bisynchX 
which emulates an IBM 3271 Control Unit 

The only limitation in the emulations is that the cluster controller 
will not support low and high intensity displays. 

In the LisaTerminal manual, page 81 gives the chart for cursor 
control characters in the VT52 mode. The command for direct 
cursor address is Incorrect. It should react 

Direct cursor address ESCYlc^ 

The keyboard layouts are shown in Appendix 4 in the LisaTerminal 
Manual. Descriptions of VT-lOO. VT-52 and TTY CONTROL and 
ESC codes are also in Appendix 4. 

If you aren't receiving a line feed character from the computer 
that youYe trying to communicate with then you n^ to Instruct 
the other computer to sand thera It is not a problem with the 
LlsaTermir^ program. In the book it sug^ts that setting Auto 
New-line to On will resolve this problem. It doesn't 

If you are having problems with clearing the screen then try this: 
set the Columns Per Line from 80 to 132 then back to 80. 

The capacity of a LisaTerminal ctocumait is 1500 lines. When you 
reac^ that limit, it will give you a message telling you to save the 
document and start on another. Otherwise. If you (xr>tlni« to 
record Information you will begin to have memory problems, and 
run the risk of losing your document 


Getting rid of page marks: if it's on a line by itself click 3 times on 
it with the mouse to select it then backspace or cut If it’s not by 
itself then click on the line below and backspace. Page marks are 
treated Just like carriage returns. 

If you want a larger margin on the top of the first page to 
accomodate a letterhead: set yajr margins for the secoral page, 
then clic^ at the beginning of the document and use the f^TLRN 
key to space down the required amount 

If you don't wart to do this every time you create a docunent 
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Doitole underline: 

Tabs: 

Formatting: 

Printing on Ri^t: 


Printing underlines: 
Blaikp^ies: 

Preview Pages: 


then tear off a new document Put in tPe rec^jiired number of 
RETURN’S at the top. Save and Put Away the document Then 
make a stationary pad out of it From then on when you tear one 
off, click down near the bottom of the document to put the cursor 
below the carriage returns. 

To double underline do the following: Set the format to single 
spaced par^ragh. Go down to the next line and type in equal sigris 
C-'). Go back and select them, set them to superscript and bold. 
Then change the type style to 15 pitch, 12 pitch Elite or PS 
Executive. The equals will blend together in these type styles to 
give you the appearance of double underlines. 

Setting tabs is described in the LisaWrlte manual on pages 
B104-B116 in the Tutorial. The method described in the book is 
the most trouble free as long as you ranember two things; to 
press the T AB key as you’re entering data; and wh^ you’re moving 
a tab on the tab ruler that all of the tabs to the right will move 
with it. 

If you are having problems with formats disappearing keep trtis In 
mind; all formatting Is held In a carriage return. When you lose 
formats It mesm that the carriage return wasn’t carried on to the 
next par^aph (l.e. you clicked In the wrong place before starting 
to type). The easiest way to fix It Is to select a paragraph that Is 
right. Copy it, select the paragraph to be fixed, then select Same 
as on Clipboard from the fomnat menu. 

Don’t set the right margin past 8“ on an 8.5’‘xll’* paper, or past 10“ 
on landscape because LisaWrite has problems printing so close to 
the edge of the paper on the right Otherwise, when you try to 
print you will get a mess^ saying that there is information 
outside the printable area 

In 2.0 this problem has crofiped up even when the margins were set 
properly. In this case if you select all of document you will see 
that there is information past the margin on the right When you 
get rid of It the ctocymeit works fine. 

In 2.0 LisaWrite, if you print underlined words in Landscape, it 
prints the word but not the ifxJerlines. 

Sometimes people complain daxjt havlr^ blank pages at the end 
of their document The first thing to do Is clid< 3 times at the 
beginning of the blart< page to see if anything is selected, 
Sometlnr«s there are carriage returns that are carried at the erp 
of the cKxjument If nothing is selected then all you need to do is 
save and put away the dcxximent This will get rid of any truly 
unused pages. 

There are a variety of display problems associated with Preview 
Pages (this includes showing the Page ruler and printing). Pieces 
of text are displayed in the wrong place, the elevator disappears, 
end text dlsqjpears. Yexi may also have prdDlems with it not being 
able to print a page in a specified ran^, or not displaying the 
document past page three. 

If yoi are having c^ral display problems, yrst avoid using 
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Preview pages or the page ruler. If you are having problems 
printing a specific p^, have that page displayed In the window 
before you prints or select a larger range. If a large portion of your 
document Is gone^ Don’t Pailc. It's still there, but not dlsplayea 
Select Don't Preview Pages, then Save and Put Away the 
document. When you open the document. It will come back whole. 
It was thought that these problems were fixed In 2.0 but we have 
received r^rts indicating that the bug is alive and well. 


LlsaCalc; 

Capacity: The ongoing question of the maximum size of a spreadsheet has no 

simple answer as you probably have deduced on your own by now. 
There are two llmltatlorrs to the size of a LlsaCalc document; the 
first is raw memory, which is no surprise The second limitation Is 
far more subtle. Calc rralntains a table of pointers to the 
locations of the cells and formulas. This t^le does not get 
additional entries wtw^ "cut and paste adjusting" is used, thus a 
larger document can be generated by using "cut and paste 
ad^sting" than by using direct entry or "cut and paste". Note that 
is a very simplified explanation of the way this pointer table is 
used so don't take this as THE explanatloa Note however, that 
the size of the pointer ta3le is being expanded enou^ to 
eliminate it as a constraint, leaving memory as the only 
limitation. The maximum size is somewhere around 500 to 400 
blocks curraitly. 


Management T echnlques: 

There are some techniques for maiaglng the size of a 

spreadsheet* 

Plan Ahead- Not only will the process of entering the 
information te easier, but as you'll s^, making changes will 
have the tendercy to increase the size of the sheet. 

Keep the information in a somewhat rectangular construction 
(i.e. not an L sh^). LisaCalc keeps track of All of the cells in 
the rectangle that contains the Information in your st^t. This, 
by the way, will also account for the Lisa printing blank pages 
on occasion. 

Paste Adjusted formulas tatfce up less space then regular pasted 
or entered formulas. The reason for this is that the adjusted 
cells contain a pointer to the original formula with an 
increment. There's a couple of thirrgs to keep in mind, trxjugh, 
whoT) using this method. First, if you paste adjust a small 
formula to a few cells, this wont save you any space. It works 
best on long formulas pasted into lar^ rarges. Second, once you 
start copying, cutting, pasting, and inserting rows or columns, in 
tr« process of readjusting formulas LisaCalc will replace the 
pointers with real formulas, thus increasing the size of your 
Sheet Plan Ahead. 
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Cell Selection: 


If ycHj want to select a range of cells that is larger than the 
window (such as Al:A100), click in the Cells area at the lop of your 
document (or press apple-G) and type the range. Pressing 
ENTER will select the range. 

Time to save and put away; 

In response to complaints that it takes a long time to save large 
Calc spreadsheets^ the only answer is that the process simply 
takes that much time. Save times of 15 or more minutes are not 
urxjommon or abnormal. There are no suggestions for optimizing 
this save time. However, if the sheet has Lookups, Ifs and 
Searches, the sheet seems to take longer to save. 

Cut & Paste: Even though you have the q3llon of cutting or copying the entire 

LlsaCalc document, pjasUng It Into any document Is not possible. 
This can have tragic consequences If you cut all of document, 
because you are unable to paste It back Into the document It came 
from. 

Cut & paste with formulas: 

When ycKj cut cells, formulas that directly refer to those cells are 
set to ERROR. When you paste, the formulas will be adjusted to 
reflect the location of the new cells. If you cut a group of cells 
and the forrrwlas that refer to thenL and paste them to another 
location, tre formulas are automatically adjusted. 

Find Misslr^ Value: Find Next Missing vaii« does not always work. The prctolem 

cKXHjrs when the selected cell is in a column that never had any 
values in it. An alert box appears that there are no missing values 
below the selectiox Be sure the selected cell is in a column that 
has another value. 

Formulas: A significant number of (yjeslions are about how to set up a 

particular formula, or which formula will do the operation 
wanted. There's no way of describing every formula here, 
however, here’s a bit of advice. Be creative, and know what your 
cations are. In the appendix of the LisaCalc manual is an 
alf^nabetlcal llstlr^ with descriptions, of all of the formulas 
available in LisaCala Use them to their best advantage, and don't 
be afraid of combining them to get the desired result 

Cell coordinate entry: There is a methcxl for enterir^ a cell's coordinates without typing 

it Just point at the cell, press the OPTION key arel the mouse 
button at the saT« tlma 


Calculation: It has bean commantai that the calculate time on Lisa is too long. 

The reason it takes longer than other calc programs is that it 
makes multiple passes, LlsaCalc will first calculate by rows, than 
by columns. It then checks the two answers. If they are not the 
same it calculates by rows again and checks to answers. This is 
contirwed intil two successive calculations yield the sanne 
answers. 
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Error results: 


Sometimes when you have seemingly Innocent formulas^ like 
Al+Bl, you may get an Enor result If Al or Bl Is blank. 
Ordinarily, blank cells are to be treated as zero In a formula But 
sometimes the progran forgets that. To get around It, just put a 
zero (0) In the blank cell. 

Precision Problems: When real numbers are used In a IF lest, you erx»unter problems 

with round off, which can cause Inconect evaluations. For 
example If you have a formula lF(Al-^A2-A3,“ok","not ok^lLarxl If 
cell Al contains 2.1, A2 contains 1.2, and A3 contains Al-^A2, tr« 
formula will return "not ok", even though the values look 
Identical, Tfie reason for this Is that values In a IF statement 
(A1+A2) have a dlffer«it preclslai thai values In a cell (A3). Thus, 
when the two are compared, they are not the same, even though 
logically they are. To get around this, use Integer numbers for 
ecp.allty tests to avoid this situation, or use an INT function In 
your IF statement 

Loc^ip; In the LlsaCalc Manual on pg. D32 It Implies that you can enter 

more than one range for Rangel In your Lookip statement Not 
true. When you enter the second range It assumes that this Is 
Range2. There Is a way of getting around this If your Lookup table 
spans more than one row or column. Let's say that you want a 
Looki^p table to look up a number In the range or 1 to 300. 
Obviously, this will be more than one column or row. In Cells 
Bl:B254 you have numbers from 1 to 254. In the column to the 
rl^t (C1:C254) you have the result to retura In Cell B255, Instead 
of entering the value 255, enter 301. This Is a mmber larger th^ 
the range you are looking la To the right of that you have a lookup 
that looks like this: L00KUP(A1, D1 ;D46, El :E46). D1046 has the 
rwnalnlng numbers In yewr Lookup table, the results are to the 
right In column E. So In your main Lookup Statement you would 
have this: 

L 00 kup(Al, Bl :B255, Cl :C255) 

If the nurnber you are looking for in Al is 260, then the value 
returned will be the result of the Lookip in Cell C255 . 

How to check for a blank cell: 

There are some Instances where yai will want to check to s^ If a 
cell Is actually empty, or blank. To test for a cell that Is blarrtc you 
n^ to corrpare It with another cell that you know will always be 
blank. Like this: 

IF(05=X255, 'blank*, 64-D5) 
assunlr^ that X255 Is always empty. 
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New vs. Used: 


Using dales in formulas: 


More About Dates: 


Net Present Valte: 


Sorting: 


On a new Calc sheet enter the following: !n cell Al-20^ A3-30, 
Aft-50, A5-100. In A6 enter MIKA1:A5). The value will be 20, 
Now enter anything into any cell (other than A2) In row 2. The 
value in A6 is now 0. The problem is that it appears that LisaCalc 
mstf^es some kind of distinction between new and used rows or 
columns. To get around this you would cut row 2 and insert 
another in it's place. 

To use a date in a formula, as for calculating cost per day, you 
need to transform the date part into a nunber. To accomplish this, 
use the INT function: 

INTCl2/4/84‘-*l/3/8A*)*500 

There are couple of problems encountered with dates: 

The first is in l.O, Sometimes when you subtract two dates, 
LisaCalc may come up with a bizarre number of years (i.e, 
-2545345 years). Once this happens you cant ^t rid of it versim 
2.0 seems to work fina 

The secoTd prctoiem is in regards to calculating dates in a leap 
year after the leap day - 3/1 through 12/30. For example, in two 
cells enter the following formulas: 

DATE-1/1/84 and DATE-12/30/85 

The results should differ by 1 , but they dont. Instead they differ 
by 2. The first will be 102, the second will be 104. There may be 
other problems with leap years. The problems are fixed in 3.0. 

There have been questions regarding the formula used for the Net 
Present Value functloa Here is an example derived from an 
accojnting book which se«ns to work: 

NPV- Kl-^D)"! ♦ I/(l-^D)'2 I/(1-^D)‘3 ♦...•► I/(1-D)''n 

wf«re I is the investment, D is the discocnt rate, l-»D is raised to 
the number of the period that particular investment value falls 
inta Basically what you're doing is finding the present value of 
each Investment for eadi period aid adding them all together to 
gel the net present value. 

Yes, there is a way of sorting in LisaCalc. Let's say, for ec^mple, 
that you wanted to sort a column of numbers (Bl©35) in 
Ascending order. To do this you need to set up an additional 
column of formulas like so: 

In the first cell (Cl) you would put 

search(Bl :B35, c«ll<result, 500, cell) 

In the next cell (C2) you would put 

search(Bl:B35, cell<result and cell>Cl, 500, cell) 

and then paste adjust it to C3^35, ^>jstlng the Cl. Tnis will 
search the range Bl:B35 ard sort tr^ in ascendir^ orcter. The 500 
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LlsaDraw: 

Pasting; 

Centered text: 

Cut & Paste from Write: 

Even Spacing: 

Shading: 

Error 3001 or 3007: 


value is any numOer larger then the largest nunoer in the range. 

To sort In Descending order, the formulas will look like this: 

In the first cell (Cl) you would put 

search(Bl :B35, cell>result, L cell ) 

In the next cell (C2)you would put 

search(Bl:B35, cell>result and cell<Cl, 1, cell) 

and then paste adjust it to C5:C35, adjusting the Cl. 

Note*. There’s a ctxiple of things you need to keep in mind when 
sorting. The first is that this will only resort a single row or 
column, NOT entire rows or columns as is done in LisaLisL The 
second is that if there are repeals of numbers in the range you are 
sortiixt they will show up as NAs at the end of the list 


When pasting into Draw, objects are pasted centered areound the 
last mcMjse click. If you haven’t clicked in the document, it is 
centered on the first page. 

If you select an object and start typify the text will be aligned in 
that Object. This meais that if you have align centers selected 
(this is the default) your text will be centered on the object 

Text can be cut or copied from LisaWrite and p^ted to Draw,BUT 
LisaDraw doesn’t know how to wrap words. So, the informaticn 
pasted is pasted in one long line. For example a paragr^ that 
may take up 5 or 6 lines in Write will be pasted into Draw as one 
long line, which may or may not fit 

There are two methods for spacing objects evenly. The easiest and 
CMlckest is to align to Auto Grid. If you want to m^e copies of art 
(*ject and have them all evenly spaced then make a duplicate, 
move it the distance you wait aid then ma<e a cM^licate of the 
duplicate. See page B70 in the LisaDraw marwai. 

Text comes with white ^lading, as cto closed ob^cts (circles, 
squares, etc.). Arcs and freehaid curves come with no shaJing. No 
blading can ma<e it hard to select these objects. Siading them 
gives you more selectable area Be aware that groi 4 )s of objects 
0ir«s, for example) camot be shaded. 

These errors, encountered when attempting to print, occur 
occasionally when using BACKSPACE to delete characters in 
text strings. Sometimes this cringes to type style of the string to 
the system font, used for the di^iay of Lisa menus axi messages. 
Unfortunitely LisaDraw ctoesn’t know how to print this. 

The easiest way to resolve the problem is to Select all of 
docLBTent, cha^ the lyi:^ style to scmethir^ else aid chaige it 
back to whatever you had. The other cation is to print While You 
Wait LisaDraw will stop printing before it has to print the 
offending text string, wr^ you’ve found it, clear it and retyf» It 
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Shrinking & Stretching: 


Pastir^frornGra^m: 

Printing landscape: 

Printing: 

2.0 stationary; 

COTTplex drawings: 

Capacity: 

LIsaLlSl: 

Sorting: 


or change the typestyle. (To identify a dad string: If you type a V 
and it looks like the V in "Save’ in the File/Print menu thai it has 
been changed.) 

This problem was fixed in 2.0^ but if a document created in l.o was 
cwverted to 2.0 and it had in it the bad text it will exhibit the 
same symptoms. Fix it as before. 

Shrinking and stretching are described on pgs. B19-B21 and 
C75-C76, Here's some things to ke^ in mind when stretching and 
shrinking an object or group of objects: 

To avoid distortion of your objects, don't lee the comer handles. 
Use the handles on the middle of each side and move each of them 
the same distance from the center. For example. If you had a 
square (2x2) that you wanted to Increase to a 4xft, you would take 
the handle at the middle of each side and move it an inch out from 
the center. 

To stretch of shrink a bunch of objects, group them first It's 
easier and sometime quicker. 

Keep in mind that Graphs pasted in from LisaGraph are grotped, 
sometimes in many layers. This means that in order to access a 
part of it you need to ungroup the objects until the one you went is 
free. 

When printing landscape, horizontal lines and text will come out 
longer than it appears on the screea The reason for this is the 
difference in resolution from the screen to the printer is a 
prOJlem. There is no workaround other than to compensate for it 
on the screan as >fou're drawing (make horizontal lines a little 
shorter, position text in boxes a little to Wb left, etc.). 

The lower most and right most pixels will not print. Avoid putting 
information into this region 

Paper tom off the 2.0 LisaDraw stationary pads are 8 pages wide. 
To make a pad with fewer pages, select the preferred Drawlr^ 
Size. Then draw a box, circle, lir^, etc, Oines white, shales nor^) 
before Saving and Putting Away the doament and selecting Make 
stationary Pal from the File/Print menu. You can throw away the 
old stationary pad if you wish. 

There have been several Instances where documents that are 1-2 
pages, but extremely intricate, have a tenderxiy to dls^^ar 
(LBiable to display ctoament). The only suggestim is to KEEP 
BACKUPS. 

The maxirrttjm that we've heard is about 300 pages. We haven't 
talked to anyone with more then that. 


Sort orders ad comparisons are discussed in Appendix 4 of the 
Lls^ist manual. One problem that people frequently have is using 
a Text format rather than a Number format for a column that h^ 
nufTters in it. LisaLlst, vmen sorting number formatted fields, will 
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Data formats: 

Zip codes: 

2.0 Conversion: 


Capacity: 


sort tnem In ascending or descerwaing numerical order. If these 
numbers are Instead formatted as text then they will be sorted via 
a comparison of letters. This means that all of the rxjnbers 
starting with 1 (10, 15, 100, 1000, etc.) will be together, the 2‘s will 
be together, etc. The only way to reformat the information is to 
add another column with the right format and transfer tr« 
Informatioa 

The different varieties of data formats are discussed in /^apendix 
5 of the LisaList manual. 

LlsaList DOES accept 9-diglt zip codes. 

There has been one problem encountered in the conversion of 1.0 
LlsaList files to 2.a In rr^inly large files, number coltmis may 
come up blank, if you click in the cell the information it contains 
is displayed at the top of the docinient, buit it won't display in the 
field. The only recourse is to add another column and reenter the 
information. 

The pitollshed capacity of LlsgLlst is: 

maximum for a list size depends on amount of disk space 
990 bytes per record 
100 fields per record 

*Keep in mind that files that used to fit on the 5-1/4" disks may be 
too large to fit on a 3-1/2" Sony and the Lisa Operating Syst^n 
will NOT split it 


LlsaGraph: 

Copy fran Calc: 


2 decimal places: 


Customize X axis; 


ChcBiglngaiades: 


To copy rows from Calc and paste into columns in Grsph you need 
to make sure that you select the entire row, by clicking in the row 
header, or the entire column, by clicking in the column header. 
Selecting as reige of cells doesn't work. If you have information 
that yoi don't want to have in Graph just cut it after it's pasted. 

Be aware that if you want to have two decimal places on the X or 
Y axis numbers, LisaGraph will Always roirKl the numbers ip to 1 
decimal place for any incremoit you choose except .05. 

To customize the x axis you need to make sure that you have a 
line graph or a scattergram selected. Customizing is described on 
pgs. C89-C93 in the LisaGraph marwai. 

To change the shaJing on the bars and legends in a bar chart you 
need to paste the gra?#! to LlssDraw, ingrotp it, then shate 
bars. 


More graphs on a p^ie; 
Capacity: 


If you want more than CMne graf:^ on a pspe then paste the graphs 
onto a LisaDraw Ckxjwnent and arrange them the way you want. 

More than 2000 data points. How mudn more isn't really known. 
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LtsaProJect: 

Comecling tasks; 

Drawing Size: 

Resource Chart' 

Dates: 

Resources; 

Scheduled dales: 

Extra pages: 


Be careful not to draw lines sloppily. For example, if you have a 3 
tasks that are supposed to happen one after the other and the date 
on the middle task starts at the Deginning of the project It may he 
that instead of connecting them one at a time a line was drawn 
from the first to the third It may look like the second task is 
comected hut it really isn't To see how far the line extends just 
click on the line. 

The maxlrmim physical size of any LlsaProject document Is 
usually 96“ X 48“. if a document Is created In landscape. It will 
only he 6 pages across by 4 pages down (69*' x 48"). When you 
attempt to add any other pages In either direction, an alert comes 
up saying the document canol be made any larger that %“ X 48". 
If you wl^ to have a large landscape project, create the document 
in portrait, then change It to laxJscape. 

Resources listed on the Resource chart are listed in the order In 
which they were entered. However, If you save arxl put away the 
project they are listed from left to right as they appear on the 
chart To get them to list In the order you want,make a task box at 
the very left side of your project and enter the rescxirces listed in 
the order you wait Save It When you open it again It will display 
the resources In that order. Any additions that you make will 
apf«ar at the bottom of the chart 

If a date shov^D on ymr task box has c^iestlons marks in It this 
meais that the date exceeds ycxir calendar ran^. This sometimes 
happens when you've set a sheduled date that caused the program 
to pu^ the dates outside of the calendar range. 

LlsaProject does not allow for resources working on different 
tasks at the same time. If tasks are not being scheduled the way 
you wish then renane your resources so that each is unlqire. For 
example if you Joe working on two parallel tasks then use Joe l 
aid J£^ 2 Instead, so that the prc^am thinks tr«y are different 
resources. Resources can also impact the s^ieAillng of ta^s 
later on In the project, so keep an eye on them. 

When you alter a scheduled date for a task then the schechjle will 
recalculate the dates to reflect It However, if the date you enter 
Is thouQiit by the progran to be impossible It will override it and 
put In a date of it's owa It will show the date underlined as If you 
had set it 

Mace sure that when entering resources and ckiratlons that you 
use TAB to move to the next field, NOT Spaces. Otherwise it 
thinks you have a duration of zera 

If you have extra pages you wait to get rid of just save aid put 
away the document and open it The pages will be deleted for you. 
If this doesn't work, tr^ charge the print orientation (i.e. 
portrait to landscapej, aiage it back, Uiai save and put away, it 
will delete the extra pages. 
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start at beglnlng of calendar: 

If the resource and task charts begin at the beginnlhg of the 
calendar insteal of the actual beginning of the project then you 
either have a task or resource without a predecessor or you have 
encountered a phantom task box. it has been reported that large 
phantom task boxes ^)pear when a shedule is copied aid pasted to 
LlsaDraw. Also^ sometimes a box will show Just off the edge of the 
sheckile. They seem to be spontaneous^ and there's no way to get 
rid of them. 

Capacity: The capacities we know about are: 

over ITOO tasks (more have been reported) 

Over 100 resources per task 
20 vacation days 
60 pages 


workshop: There is some confusion as to what the Workshop is. The Workshop 

is a Shell that rms under the same operating system that runs the 
Lisa Office System, it is a develcpm^t environment that includes 
a system mana^r, file manager^ the mouse editor and other 
utilities. The workshop is sold as part of each language package^ 
thus buying any of the three currently available languages 
O^'ascal, Basic, C(*ol) will include the work^iop. All three 
languages include a language reference manual (2 volumes for 
Cobol) and a Workshop Users Guide. Only the Pascal product 
coiTCs with the operating System Marwal since only Pascal has 
to moot Qf the foatiurp^ dpcoribpct. langMagp U 

packaged as a stand aione pttwudt m the uiiia, thetemh* eeeh She 
iTKist come with the complete Workshop environment Note: The 
Pascal package also includes the 68000 assembler. 

Eliminating LisaBug: For better or for worse, LisaBug comes as part of the Workshop in 

the form of two files: SYSTEKDEBUG and SYSTEMiDEBUG2. In 
version 1.0 of the software, the mere presence of these two files 
enables the NMl key (non-maskable interrupt) in the Office 
System. This can be very distressing to end users when they press 
the NMI key, the minus sign on the keypad. There are two options 
to deal with this problem; 1) char^ the NMl key code or 2) dis^le 
the debugger conipletely. 

The latter qption is very simple, but will cwnly last for the duration 
of a sessic»^ The next time the system is rebooted the NMI key 
code is set back to the minus sign on the key pad To change the 
key cocte for the session use the following procedure: 

1. Enter the debug^r by pressir^ the NMI key (minus sign on key 
(»d). 2. Enter die command "NM 0’ and a carriage return in 
response to the d^xjg^r prompt of >. This sets the key code from 
hex 21 to hex 0 O-e, no key)*». 3. Type a ‘g* and a carriage return to 
return to your starting poinL 
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Program termination: 


To dis^le the debugger there are three options: 1) delete 
SYSTEKDEBUG and SYSTEM.DEBUG2, 2) Change the nanes of 
the two files to sorneming besides names starting with 
SYSTEKxxxx (this enable easy restoration at a later time) or 3) 
transfer the two files to floppy, thus freeing up the disk space 
until the user wants to restore the debugger. Note; you must 
reboot the system before these changes will be recognized by the 
operating system. 

» When respeclfylng the NMl key, to need to specify the key 
location not the ascii code for the character you want. The table 
of key codes Is on page F-6, table F-i, in the Pascal Language 
Reference Manual. 

There are a couple of ways to terminate a user program which Is 
in m infinite loop from LlsaBug. When you find your program In an 
Infinite loop press the NMl key to get Into the debu^r. If the 
domain Is greater than zero (l, 2 ,or 3), then type a ’G 0’ and press 
RETURN. This Will bring you back to your progr^n then 
Immediately return to Llsabug. Then type a *G* and a RETURN. 
The program screen will redl^lay with the message Process had 
a bus error*. Control is returr^ to tr« shell. We have also used the 
seqtence of ‘PC 0* fromLisalxig to set tp an exception then 'g 0’ to 
return with a Bus error. Again this works fine from a domain 
greater than zero. 

It Is sometimes hard to ^t a non-zero domain If the program is 
cai^t up in I/O. You can soinetlmes tjpe UBR* In the detxigger 
which win caise a break In user code (ctomaln greater than zero). 

Here is another situation you may get into; Here we have a 
program with a procedure as follows: 

Procedure GMT; 
begin 

exlt(PROGRAM_NAME) 


end; 


You must Inclucte a reference to GMT in the malnprogram or the 
Dead Code Analysis will remove GMT from the ob^t code. 
When you wish to terminate the program Invoke Llsabug with the 
ntmerlc keypad *-* 0sHl) and enter the following immediate 
conmnands: 

br 

ixmovem.1 d0-^,-{37) 
quit 

The program will terminate and return you to the work^xjp ^ll. 
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Pascal 

Using Serial Ports: How to use Serial ports in Pascal: There have been problems 

using the serial ports for output, the following suggestion may 
relieve some of them. 

Although the serial ports are not file storage type devices they 
must be specified with a dummy file name since Lisa handles all 
I/O devices In the same way (see Curating system ManualX Thus 
when using a serial port give It a dummy file name for the 
pathname. Example: 

reset (f, ’-rs232a-xy2*) where xyz is the dummy name 

If you are going to be writing a program to talk to some other type 
of device, like a card reader, or test equipment, then you should 
take a look at Chapter 2 in the System Software Manual, 
particularly the Devlce_Control procecLire on pgs. 2-24 thru 2-32. 
This allows you to configure the drivers for each of the ports to 
allow communication with other devices. 

Creating shells: To create ycMjr own envirament shell, essentially all tr«t is 

needed is to refiame your staidalone pascal code to 
ShELL.“somethir^“. Once its named “sheir, the environments 
window will allow you to start it up or if you set the defaults, it 
will automatically start up. You may also need some special code 
to shutdown the shell properly. The cocte and explanation is too 
long to write here, but if you are seritxis about writing codte and 
making it a shell let TKih Comm know and they will send the 
information to you. 

Mojitlng SNid reading twiggy diskettes: 

Once you have detected the insertion of a disk into the drive by 
using KeybdEvent, (evenLkey in [1,3]) you must do the following 
to mount and read the directory. 

rTK)unt(enor,volname43asswdjdevlce) 

reset_catalog(error,pathname) 

then read the file nemes until done, error 846 

get_next_entry(error43refix,filename) 

All of these file systwn calls are documented in Chapter 2 of the 
System Software Manual in addition to other calls that will allow 
you to ^t additional Information abcwt the files other than the 
filename, 

units: There has been some question as to whether units are available in 

Pascal. As It turns out, you can go ahead and compile a rec^lar 
unit (although the noanual gives you a minimum of Information), 
but you don't have to put It In a library to use it, as for the Afple ll 
and III. YOU cannot, however, create your own Intrinsic units. 
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To compile a regular unit you v&ed to irKtlude a ccmpiler command 
at the beginning of your unit. 

{$U-1 

Unit Sample; 

Interface 

Implementation 

end. 

Just include the object code file in your program's uses 
statement The only problem that we have ©rxxxjntered is nesting 
units. This seems to have problems. 

Lisa Application File Structures: 

Lisa division has stated that they do rwt have the resources or the 
time to publish the specifications of the file formats for Vne 
existing Desktop s^llcations. Unfortunately each application 
has its own format since they were all developed somewhat 
Independently. This very problem is one of the main issues that 
Toolkit should t^e care of since it will st^xlardlze data 
representatioa 

Numerics: F*ascal numerics are discussed in Appendix D of the Pascal 

Langu^ Maiual. It discussed 16^ 52, 6A and 80 bit 
representations of numbers and how to access the routines to use 
tt^m. 

Basic ntinerlcs are discussed in Section 4.1.2 of the Basic 
Langu^ Maxial where you will note that all real nunnbers In 
Basic are double preclsic»i (whldi helps account for Basic's less 
trwi blinding speedX Also see Appendix B in the same manual. 

Pictures: There has been a prctolem using Pictures In GMckdraw. One thing 

that they neglected to include in the book is that before you do do 
any picture drawing you need to set the ClIpRecL .Xist Include 
this linein your prc^ao; 

CilpRecUthePort " 4 X)rtBitsjDounds); 
before you do any picture drawing. 

TextSlze: TextSize doesn't seem to work. Use pictures instead. 

Printing Gr^lcs; In the current implementation of Quld<draw there is no facility 

for printing gra^^ilcs. if you just want to print the screen you can 
gp to the detx^ger afKi s^Ify which screen axl printer. The only 
limitation Is that the debugger only prints to a parallel DMP. See 
pgs. 8-18 throu^ 8-19 in the Workshop Manual. 
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Type Styles: 


Quickdraw Samples: 


If you want to write your own routine to print graphics, it is 
possible using the printer ESC sequences. The only thing to 
remember is that when you are opening the printer, make sure you 
specify the actual port it is connected to in the pathname, instead 
of -printer*. See the sample programs at the back of this 
document 


There are a variety of typestyles available to you in QuickDraw. 
Unf ortunitely, these are not listed in the book, so here it is: 


Font#0 
Font#l 
Font *2 
Font #3 
Font #4 
Font #5 
Font #6 
Font#? 
Font #8 
Font #9 
Font #10 
Font #11 
Font #12 
Font #13 
Font #14 
Font #18 
Font #19 
Font #20 
Font #21 
Font #22 
Font #49 


system font 

Small icons and symbols 
LisaOraw shading patterns 
More icons and symbols 
ps pitch, 12 point, sans serif 
ps pitch, 18 point, sans serif 
ps pitch, 24 point, sans serif 
15 pitch, 9 point, sans serif 
12 pitch, 12 point, sans serif 
10 pitch, 12 point, sans serif 
ps pitch, 12 point, serif 
ps pitch, 18 point, serif 
ps pitch, 24 point, serif 
12 pitch, 12 point, serif 
10 pitch, 12 point, serif 
Calculator symbols 
20 pitdv unknown point, sans serif 
LisaGraph tic marks 
18 pitch, sans serif 
Large icons and symbols 
LisaGuide icons and symbols 


To access U«se type styles, use the number of the font as the 
parameter of the TextFont proc^Jure. To explain some of the 
terms used, pitch is the number of characters per inch, ps pitch is 
proportior^ spacing. Point is the size of the characters. Serif is 
the style of the character: Serif means the “exKXrtive" or 
“classic" type styles. Sans serif represents the "modern" 
typestyles. 


This is an example of serif 

This is an example of sans serif 

Font numbers not listed are comprised of undefined characters. 

Quickdraw samples are included at the end of this documwt They 
include rww to get characters from the keyboard, display them on 
the screen and simple editing. Also included is an example of how 
to define the mouse cursor, conversion of text strings to numbers, 
and other fun things. 
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Cobol: 


Developm^t Tools: 

Printing: 

Basic: 

Available Memory: 

Printing: 


QiddcPort: 


Toolkit- 


Apple does not have any development tools for Cobol other than 
What is offered in the Cobol language product Other Cobol tools 
may be available from Micro-Focus^ the people that wrote the 
Lisa Cobol for us. Direct your requests to them. 

There have been problems printing to a printer on a parallel card 
in slot 3. Slot 2 seems to work fine. 


For those who want to know how large the program area for Basic 
in the Workshop is, please take a look at the discussion of the 
Length command Section 3.3.2.2 in the Basic Language Manual. 
Length gives you the amount used by your program and the total 
amount of program area available. 

Printing is discussed in Chapter 5 of the Basic Language 
Reference Manual on pgs. 5-5 thru 5-9. An example of how to 
open an output channel for the Printer is on page 11-2. 


Lisa QulckPort, also known as “the Vaiilla Window" is being 
designki as a way of running a straight Workshop type program 
from the Office System desktop. The idea behind quickport is to 
let a user port a program that is currently running elsewhere to 
the workshop envtronmehL The user must then get the program 
up and running in the workshop. QuickPort would then enable the 
user to open a window on the desktop and run their application 
program. Decisions are currently being made on ways of 
suKwrting graphics and the mouse throj^ the winctow. 
Quic^cport is expected to be available in the ^ling release of 
1984. 


The ToolKit is currently available to registered develc^rs only. 
ToolKii is based on Clascal whic^) is a superset of Pascal and is a 
powerful Object oriented language. Using ToolKit a deveK^r 
will be able to fully integrate an application onto the desktqa in 
the Dff ice System. 

The ToolklL however^ will also require a significant commitmart 
in time and effort to learn and should be used when there is a 
genuine interest in integrating with the rest of the Dff ice System. 
Users that want to extend the functionality of some of the cunait 
applications (such as accessing Calc or Project documents) should 
definitely consider using theToolKiL However, be aware that the 
Toolkit will NOT be supported. You’re on your owa 
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Disks: 

Diskette is Deteriorating Message: 

7T»is means that some Dad blocks have been encountered on the 
diskette and spare good blocks are starting to be usea There is a 
directory which contains addresses of good blocks tr»t can be 
used as spares. But if you get too many bad blocks on your 
diskette you will run out of good spare blocks and the spare block 
directory will be exceeded. This is when the diskette becomes 
unreadable. So^ if you get the message that the diskette is 
deteriorating, its time to start thinking about putting the 
documents onto anoW«r diskette. The other possibility is that if 
the disk works fine in other drives then there may be something 
wrong with the drive. 

ProFlle - Memory Loss: If you suspect that you don't have as many blocks as you should 

then turn off the system and do a r^oair. in the Lisa 1 Owner’s 
Guide it’s on pg. D53. In the Lisa 2 Owner’s Guide it’s on pg 024. 
Do steps 1-6, on step 7 click Don't Install, then skip to st^ 12. 

Boot PROM versions; When a Lisa is booting the ROM versions appear in the upper left 

hand comer of the screen (not true for older nrechines). The letter 
indicates the boot ROM versloa A slash then s^rates the letter 
from a two digit number that Indicates the floppy drive ROM 
version. 


hflscellaneous: 

Page Nunr«)ering: These examples win show how the Lisa Office system numbers 
pages In documents that extend both horizontally and vertically 
over more than one page. These examples are for four pages. 


extending the numbering scheme 
obvious. 

for additional pages ^xxild be 

Calc, Graph, List 

1 

3 


2 

4 

(by columns) 

Project 

1 

2 



3 

4 

(by rows) 

Draw (In portrait format) 

1 

3 



2 

4 

(by columns) 

Draw (In landscape format) 

1 

2 



3 

4 

(by rows) 


This ordering is useful for those occasions wf«n a user wants to 
print only a portion of a document 
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Screen Dumps; 


To do a screen dump^ press the left-hand OPTION and SHIFT keys 
and the 4 on the kay pad, all at the same time. If you are using 
version 1.0, this will only print to a DMP on the upper port on the 
parallel card in slot 2. In venion 2.0 it will print to any dot matrix 
printer in any slot 

Spontaneous reset A Lisa that resets itself spontaneously may have a bad power 

supply. A lisa that starts itself up has a bad I/O board. 

Dialog boxes; When you get a dialog box with buttons, you may have noticed that 

one of the buttons has a heavy outline. This indicates that that 
option is the default. Most of the time, if you click outside the box 
the default sel^tion is automatically select^l. 

Empty folders: if you have lost the Empty Folders pad, there is an easy way to get 

another. Every initialized or repaired disk has a pad of Empty 
Folders. Just make a duplicate from one of these diskettes onto 
the Profile. 

Accessing the Environments Window; 

This Is a summary of methods of accessing the enviroments 
window: 

1. Office System; 

From the Office Syst^ press the on-off switch while holding 
down the apple key to access the environments window, 
(Owner's Guide pg. G26 and Lisa 2 Owner's Guide, pg. G55.) 

2. Workshc^; 

(Q)ult the main command line and respond Y to leave editor 
etc. Respond with an A to get Another_aiell, this brings up the 
environments winctow. 

5. While booting; 

Press any key on the keyboard except Caps Locst after the 
double click. The double click occurs at the end of the self 
tests, right before you see the large hour glass on the screen. If 
you specified the start up device from the "Start Up From..." 
menu then press any key after starting Uie boot 

Magic Lisa Keystrokes: A reediest was received for a summary of special Lisa keystrokes 

such as NML and scr^ dumjK. Such a list does not currently 
exist Nearly all of the so called magic keystrokes in the various 
marwals. Screen dump - see Owner's C^ide, NMI and screen 
dumps from workshop - Workshop Manual, Debugger sectioa 

Copy Protection: There has always bear a bit of confusion about how the copy 

protection on the Lisa works, AgalO/ here is a description of how 
it works: 

When a tool is copied for the first time it is Imprinted with the 
serial number of the Lisa it is first copied on. This binding 
happens almost Immediately so aborting the copy will still leave 
the master diskette tied. From then on ail copies from that 
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master will only run on tnis first system. 

You can make as many copies as you like and on any Lisa/ But the 
copies will only run on the first Lisa the master was copied oa 

The master diskette can run on any Lisa BUT the tool cannot De 
copied onto the profile and run. 

The serial number Is contained In a prom located at position C6 on 
the CPU board. If vne CPU board is replaced for any reason it Is 
important that this prom be placed on the new boards otherwise 
the software will be unusable on their system, if the Prom Itself is 
bad then a new prom can be burned for the system or new 
software Issued. 

Which tools are protected: 

The TOOL (spiral binder type icon) for each of the Lisa 
applications is protected. If you look at the file listing they look 
like "{Tl}.obf. The stationary Office System l-A^ and 
LisaGuide are NOT protected. 

In Pascal: Pascal.obJ, Code.obj, and EdItor.ob) are tied. 

In Cobol: All of the cobol overlay files are tied., and, of course, 
Editor.obJ. 

In Basic: Baslc.obJ and Edltor.obJ are tied. 

Spares Kit - Software*. Software was not added to the spares kit because of the cost It 

would add to an already expensive kit Spare diskettes can be 
ordered by dealers through the reglcnal support centers like any 
other spare part. It Is up to the IrKlIvldual dealer to determine 
whether those spares are necessary and In what quantities. There 
is also a program available v^reby the dealer gives the user a 
care which Is sent directly to Apple. The required diskette Is then 
sent directly to them. 

External Sony: There are currently no plans to have Lisa 2’s support an external 

Sony drive under the Lisa operating system. There Is an excellent 
possibility that Macworks will support an external Sony drive 
however, there Is no timetable for when the hardware to 
Implement this will be available. 

T ransfer of warranty Information: 

The procedure for transferring warranty information when an erxl 
user sells their Lisa to another end user is; Drc^ a note to 

Apple Computer, Irx::. 

20525 MarianlAve. 

Cupertino, CA 95014 
Attn: Linda Maybrook, M/S 23H 

In Vne note include the name of the seller, name of the buyer and 
the serial number of Uie Lisa. 
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Llsa2: 

1/2 Megabyte: TTiere seems to be a rHjrnber of questions about what software will 

work without a hard disk drive and what software will run in a 1/2 
meg of memory. 

1. The Office System will not run In i/z meg and will not run 
without a hard disk, in fact If you try to startup the Office System 
1 disk with only 1/2 meg youTl get an 885/315 error (not enough 
room to start up)l 

2. The Workshop was originally intended to run in 1/2 meg of 
memory (that’s why the 1/2 meg option is in Prefererces), 
however, there are some major problems. Setting the 1/2 meg 
option in Preferences and then rebooting into the Workshop 
causes major difficulties. The first problem is that the system is 
so unbelievably slow it’s painful. The second problem is that 
almost nothing will run, sucSi as: Preferences, Editor, Pascal, 
Basic, need I say more? Not being able to run Preferences is a 
real problem bKsause you can’t reset the memory to l meg. You 
end up taking your ProFile to another machine to rewrite the 
preferences file on the ProFile, m^while unplugging the Lisa 
and turning off the battery switch long enough to erase parameter 
memory. 

3. Running workshop without a hard disk: In version 1.2, If you 
boot Pascal 1 and answer no to the first question *t)o you want to 
go on with this’’ you end up with the Workshop command line. 
Everything works fine except that It is slow because each 
program must come In from the twlggles instead of the hard disk 
and if you want to run some code not on the bool disk you must 
Run it rather than invoke It from the command line. For example 
the editor Is on Pascal 3, therefore you must put P^cal 3 In the 
other drive and type R, followed by -lower-editor (^sumlng cH^ 
Is In lower twiggy drlveX 

On a Lisa 2 this method doesn’t work because the install now looks 
like the Office System Install. There is no way of running the 
Workaiqj shell from diskette. 

4. Mac Works will run In 1/2 meg. 

Please let's be real sure that everyone knows these limltatioTs 
(especially the sales folks, both A^le and the dealers) because 
we don’t want to have to put up with Irate people who find out that 
they are going to have to shell out big bucks for a 1/2 meg memory 
board to run the software they bought because ’Toy demer told me 
It would work". Be on trie look out for Lisa 2/lO‘s going out with 
only 1/2 meg. This has happened quite frequently and the people 
who get them are not very h^y. 
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Copying OSl-a disks: 


Backup: 

Whenlobaa<up: 

Full Backup: 

Incremental Backup; 

Duplicating: 

Backup problems: 


The easiest way to copy the Office System diskettes on sony 

media without an external drive is the following: 

1. Start up and get Into the Workshop. 

2. Types to get Into the System manager. 

3. Set FllesPrivate to Yes in system manager^ then Quit the 
System Manager. 

3. Go Into the File Manager and Copy all of the files on the 
diskette to ProFlie with a unique prefix, e.g. Copy 
-lower— 

4. Swap disks so that destination is in the drive and copy all the 
files bojk to flow)y, this time stripping the unique prefix, e,g. 
Copyzx-^-lower— 

This method allows you to create as many duplicates as needed 

from the prefixed files on the hard disk. 


It Is Important to ba^up any documents you feel are important If 
something were to haj^en to the document or the hard disk, you 
will definitely be glad you have backups. There are 3 kind of 
backups. The first is a full backup, the second is an incremental 
backup, and the third is a dupiicatiori of tTie document onto cfisk. 
To do a full or Incremental backup you In^rt a diskette, duplicate 
the hard di^ and move it to the diskette. It will th^ olve you 
messages on how to proceed In the Lisa l Owner's Guide it is 
described on page D14-D16. In the Lisa 2 Owner's Guide, backup 
lsonpgs.B32-B37. 

A full iMckup in version 2.0 will copy all of you files on the Profile 
or internal disk onto diskettes- This incluctes any Workshop files 
you may have. For a Profile this could mean as rrany as 20-25 
Sony diskettes, an internal 10 disk could be coixeivabiy 
more. 

A full backup on 1.0 does Not copy all of the files on the Profile. 
Therefore, it will not ba:kup the workshop. 

An incremwtal backtp will only backtp those files tr»t have 
changed since the last backup. In i.o this doesn't work very well. It 
copies everything. It it done the same as a full backup. 

The most trouble free method is to duplicate your dociffnents onto 
diskettes. The only problem is user error or neglect. 

There are a few problwns with backup that you should be aware of. 
In 1.0, when you do a restore from backups it wipes out 
Preferwces, The only way to recover it is to do a full Install (l.e. 
erase the disk and reload everything). To get around this, you can 
duplicate the documents on the Backup disks to the Profile from 
the Office System. We assume that 2,0 restore works. 


27 




As was mentioned ^boMe, an incremental backup in 1.0 copies all 
of your documents^Not just the changed ones. We dont know if 2.0 
wasfixKt 

In the 2.0 Owner’s Guide on page B36, item number 7, it says that 
“Everything on Internal Hard DisK, the Internal Hard Disic Is about 
to be erased." This error message is not correct It will r»t erase 
the hard disk. It should and wilt look like the message in item 10 
on the next pa^. 

Sometimes the batstup will choke on about the 3rd or 4th disk. This 
seems to happ^ after the system has be^ us^ for a while or 
maybe there was a hang in the system’s past It typically give you 
a message saying that there is no room on the diskette after that 
diskette has been erased usually the only recourse is to reinstall 
the system^ defeating the purpose of the backup. 

On a Lisa 2, if you are trying to backup a Profile containing a large 
file to a microdrive (>728 blocks), when it gets to the point of 
copying the file, the system will continue to ask for the next 
diskette for backup, attempting to find a microdrive diskette that 
has enough space to backup the large file. This is not possible, as 
the microdrive diskette has a total storage capacity of 764 blocks 
and the system Will Not copy the file on multiple diskettes. You 
might consider making duplicates of these large files and storing 
the duplirates on the Profile or getting another Profile for 
storage. 


Lisa2Mpgrade: 

Up^ade kit problems; Just for those of you out there that haven’t already confronted 

and overcome the upgrade kit problems here is a summary of what 
transpired. 

a Motherboard revision 

During the boot procedure a Lisa would often display error 82 
or error 10726. Usually diis was fixed by swapping the I/O 
board. However, Ma;ro reported a high number of I/O boards 
sent to them with r» trouble found when tested. It turns out 
there is noise over the parallel port to the ProFile which 
occasionally resulted in the errors mentioned above. This 
problem has been rectified by terminating all the signal lines 
with resistors, the one side ef f«)t of the fix is that the built in 
parallel port will no longer support a printer. The boards can 
be distinguished by sreing the resistors clustered aroind the 
parallel port in the future whenever an I/O b(ml is swapp«3 
it is recorT¥nenciKf tr«t the motherboard be upgraded to the 
version with the signal terminating resistors. 

b. BOOtROMS 

Some kits went out with the low ROM labeled high and vice 
versa while some kits went out with the high ROM labeled low 
and I think they even manage to get some kits out the door 
with the ROMS labeled correctly. This is not a big problem as 
the old ROMs, version D, will work just fine with tr» 2.0 
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Troubleshooting: 


hardware, the only aromalles that mi^t be encountered are, 
twiggy icon Instead of a Sony and the system tells you it Is 
having trouble with the upper drive (no kidding, since there 
isntone). 

1) Symptom; Operating system error 10726, or error 82. 

Problem: Motherboard-ProFiieinieractioa 
Solutions: 

a) Replace Motherboard with upgraded Motherboard 
(Included with dealer Inventory upgrades, available as 
service spares In March.) Ensure that I/D board is also 
upgraded. 

b) use a different ProFile. 

2) Difficulty. CPU boot error 43. 

Problem: CPU boot ROM interaction. 

Solutions: 

a) Replace CPU board with upgraded CPU board, (available 
as service spares in March.) 

b) Use original Lisa boot ROMs (rev. D); only difference in 
operation between rev. D and later rev ROMs is slightly 
different icons in boot menus. (The differerxje is that 
there is an option to boot from two floppy drives when no 
second floppy drive exists; if one selects the top drive, 
tr« system will hang, arxl must simply be reset). 

3) Difficulty Blank screen when attempting to boot system 
after retrofitting. 

Problwn: Incorrectly lulled or pla:«d CPU ROh^ 

Solution: Check that CPU ROMs are inserted according to 

directions. If not incorrectly installed, one or both may be 
mis-iabell«l Use original Lisa boot ROMs (rev. D); only 
differaxe in operation between rev. D and later rev ROMs 
is slightly different icons in boot menus. (The dif feraxe is 
that there is an option to boot from two floppy drives when 
no secorxl floppy drive exists; if one sela;ts the tqj drive, 
the system will txng, and must slrrply be reset). 

4) Difficulty System goes through self test then hangs. 

PrOilem; System is trying to start from nonexistent drive. 
Solution: Reset and from tell it specifically what drive to 

boot from. This problan only occurs when the CPU roms are 
not inserted. Wha> the systan is urplugged for the upgrade, 
the time on the clock is usually lost When this reppens, the 
system always assumes that you are starting up from drive 1 
for a repair, no matter what tbe Preferaxes are. So, it tries 
to start from drive 1 and ha^, because drive 1 is no longer 
there. 
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LisaGuide: 

Starting LisaGuide; 


Boot problems: 


installir^asaShell: 


MacwtMks: 


The most common problem with LisaGuide Is starting it up. The 
LisaGuide disk does not have any system information on it for 
startup. So, in order to start LisaGuide, you need to start up the 
system from the Profile. If you try to start if from the diskette it 
will give you a Lisa icon crossed out and an error 10735. Oust 
select Startup From..., then Profile. 

Sometimes the system will refuse to start up LisaGuide. "me 
system will appear to start normally, then the LisaGuide disk is 
kicked out and you are shown the Environments window. When 
this happens, there are two things possibly at fault Either the 
Office System is somehow damaged, or the LisaGuide disk is 
itself damag«l First repair and reinstall the Office System (see 
pg 3, this document), then repair the diskette. If it still doesn’t 
work, have the diskette replaced. 

The following describes the procedure to Install LisaGuide as a 
shell that can be axessed through the environments window 
instead of from a diskette at boot time. 

Copy all the files on the Guide diskette to the ProFlle with the 
following exception: IMPORTANT, do not copy these files or your 
ProFlle axis up looklr^ like a dlsketta 

{•CATALOG} 

{•CATALOGjSR 

{•SAVEDESKTOP} 

BOOTpTFCATALOG} 

Ranember to set FllesPrivate to Yes in the Systan Manager to 
copy all Vie files Viat start with {. 

Change the name of LISAGUIDE.SHELL to SHELL.LISAGUIDE. 
The next time tlx system is bxted the environments will contain 
a Shell listed as LISAGUIDE. 


At release, Macworks will recognize the two serial ports for 
printers and modems, an external Sony and the full i me^y te of 
memory, if available. 

The Macworks package will Include Macwrlte and MacPaint at a 
price of $195. MacWorks will be bundled with the Lisa 2 but will 
be additional for the Lisa 2/5 and the 2/10. 

There are plans to make MacWorks recognize the Lisa hard disks 
but this will not be available at first release. 
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TWrd Parly Software: 

To be a developer; 
Unix software: 


SejndceMode 

Reading serial*: 


When a company announces the availability of a non Apple 
software product for Lisa THEY should be contacted for further 
information. The division provides technical support for 
developers, but Is not prlwy to their marketing strategies or 
schedules. For example, when Ryan-McFarland announces 
RM/Cobol applications on Llsa/Xenlx, call Ryan-McFarland to 
find out Who and when, once they have gone public with an 
announcement they are fair game for you to call. 

If you, or someone you know, wants to be a developer for Lisa or 
Mac, call Software industry Relations at(ft08) 973-4986. 

If you have questions about Unix and what software is available 
for that operating system, here's a couple of numbers to call: 

Santa Cruz OperaUcwis 
500 Chestnut St 
Santa Cruz, CA ^060 
(408)425-7222 

Unipress Software 
1164 Raritan Ave. 

Highland Park,NJ 08904 
(201)985-8000 


One very nice feature of the service mode is the ability to read 
the serial number and AppleNet number of a Lisa For all of you 
who don't have serial number stickers on your macSilnes and want 
to find out what It is read on below. 

Obtaining the Seria Number from Service Mode 

1. Restart the Lisa from an yiattaihed ctevice, i.e. boot from 
upper drive When there is no disk in the drive. 

2. When the Lisa gives an error hold down the Apple key while 
holding down the 'S' key. 

3. When the Service Mode menu is displayed select display 
memory 

4. Wh^ prompted for acoress, type 240 <(>^>. 

5. When prompted for COUNT, type 20 <CR>. 

The Service Mode window will look something like this; 

00000240 OFOF 0002 0802 0002 0000 0400 0500 OFOF 
00000250 0000 0100 0004 0102 0002 0900 0000 0000 

The Serial Number is stored in toe lower nibble, toe second half of 
the hex number. The serial number is 11 bytes long. 
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6. First remove every other nlDble like this: 


Newsletters: 


00000240 OFOF 0002 0802 0002 0000 0400 0500 OFOF 
240 FF 02 82 02 00 40 30 FF 

7. Then group the numbers like this: 

Nibble NunDer (Hex) 01 23 45 678 9ABC 0 EF 

Address 240 FF 02 82 020 0403 0 FF 

XX PP YY OOOSSSSX XX 

This grouping of nibbles now tells us the Serial Njmber as follows: 


Nibbles 0^1X>;E and F are ignored (marked as x above). 

Nibbles 2 and 3 are the two digit plant code (P). 

Nibbles 4 and 5 are the two digit year code (Y). 

Nibbles 6^ 7 and 8 are the day of the year code (D). 

Nibbles 9 thru C are the 4 digit serial number (S). 

The >AppIenet Number is found on the next line of the memory 
dump. The /Vpplenet number is in the first 8 bytes, 

8, Using the same method we get 

00000250 0000 0100 0004 0102 0002 0900 0000 0000 

250 001004 1202900000 


Nibble Nlirtber 012 54567 89ABCOEF 
Address 250 OOl 00412 02900000 
PPPNNNNNXXXXXXXX 

This grouping of nibbles now tells us the Applenet Number as 
follows: 

Nibbles 8 through F can be ignored (marked as x above). 

Nibbles 0^ 1 and 2 are the AppleNet prefix (P). 

Nibbles 3 thru 7 are the AppleNet number (N). 


There are currently three newsletters/magazines available: 

Professional Solutions 
The Editor 

20525 MarlanI Ave. 18-AK 
Cupertino, CA 95014 

ICON 

Apple Lisa Association 
P.O.B0X634 
Santa Clara, CA 95050 
($40.00/yearmember^lp fee) 
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/Vrtl-Thefl Device: 


F^pain 

When to repair: 


Probl«hs: 


Minor r^jairs: 


Signal 

Semaphore Corp. 

207 Granada Drive 
AptOS^CA 95003 
(Free to Lisa owners) 

St Mac 

Soflalk Publishing Co. 
P.O.Box 60 

North Hollywood, CA 91603 
O^Tee to Lisa ownere) 


There is one anti-theft device available for the Lisa: 

Anchor Pad of Northern California 
1255 Post St, Suite 723 
Sai Francisco, CA 94109 
(415)441-2593 


Anytime you have a system failure, reset, pcwer outage, or any 
other kind of abnormal power down, you need to do a r^ir. A 
repair is basically a disk clean up, which closes any files that are 
left open, get rid of any unused scratch files, and reconstruct trie 
catalog files if necessary. Other occasions when you may want to 
do a r^iair are: for any kind of straige behavior in the system, or 
If you're having any problems s^lng the files on a diskette. 

There are some problems associated with repair that are kind of 
annoying. The first is that there are some Instances where the 
catalog files are so badly damaged that they have to be totally 
reconstructed. This isn't a problem because it will come back with 
all of your documoits, but you may not have any file folders. For 
some this is a major problem that may take a cotple of hours to 
straightea The reason trat file folders are lost is that file folders 
are imaginary. They are a construct that is kept in the 
Savedesktop file to help you organize your documents. There is no 
way of avoiding this. It seems to be a frequent occurance, 
unfortunitely, in 2.a 

The other problem with repair is that if Preferences is somehow 
cfamaged during the hang or power outage, etc., repair will not fix 
it. When you try to open preferences it will ^ve you a message 
saying that wa Lisa can't find a usable copy of the “tool tool", and 
to Insert the diskette. Trie only way to restore Preferences is to 
reinstall the entire Office Systen. 

When you get a message sa)^ng that the disk needs "minor repairs" 
this is not like doing a repair from Office System 1. What this does 
Is it reconstructs the catalc^ files. That's all. So if you've (tone a 
repair, you startup the Office System, and you get this message, 
tell it to r^air. The two are not the same. 
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Pascal Examples 


ftxjgram Fk*intTest; 

USES 

C$U-} 

{$U QS/QuickCraw } QuicklDraw, 
{$U QIVQDSapport ) QrSupport; 
C$U+} 


VAR 

heapBuf: ARRAY [0.. 10000) OF INTEGER; {must keep array under 32K t)yte limit} 

rryPtaH: GrafPort; 

printer : text; 

convert : array 10..7) of integer; 

FictPointer : Pichandle; 
picframe : rect; 
dooonvert : bcxslean; 


FUNCTION HeapFuUChz: QDPtn bytesNeeded: INTEGER): INTEGER; 
( This function will be called if the heapZone runs out of space } 

BEGIN 

WRITELNCThe heap is full. The program must now terminate! ’); 
Halt; 

ENI^ 


Procedure Erawstuff ; 

VAR i; INTEGER; 
rryRecl: Red; 
dstrect; Rect; 

Begin 

ClipRedCthePort''.portbits.bounds); 

setrect(m(yrect,0,0,200,100); 

PidFraroe: = mjyRed; 

Pictpointer : = openpicture(PicFrame); 
showpen; 

FillRect(miyRect,gray); 

FrameRedCmyRed); 

EraseOvalCmyitect); 

Moveto(60,60); DrawstringC’HeUo. My name is Ginger’); 
hictepen; 
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ClosePicture; 

setrectCdstrect,150,150,500,300); 

DrawPictureCPictix>irvler,dstrect); 

end; 


Function BinToDec; integer; 

var I : integer; 

Len : integer; 

Base : integer; 

DecNum : integer; 

Begin 

If dooonvert = true then begin 
Len := 7; 

Base : = 1; 

DecNum := 0; 

For I ; = 0 to len do Begin 

if ccnvert [i] <> 0 then DecNum := DecNum + (Convert [il*^Base); 
Base ; = Base * 2; 

End; 

BinToDec : = DecNum; 
end 

else BintoDec : = 0; 

End; 


Procedure PrintScreen; 

Var x,y,i,j,k,L : integer; 

Lines : integer; 

Temp : toolean; 

Begin 

X : = 0; 

y :=0; 
j: = 0; 

L :=0; 

Writeln(printer,chr(27)/q’,chrC27)/T%16;2*chK27),’ZHR0; 

Repeat 

For k : = 363 downto 0 do begin 
doccnvert : = false; 

For i : = 0 to 7 do begin 
3 :=X+i; 

temp : = GetPixelCj»k); 

If terr^ = true then begin 
convert [L] ; = 1; 

L : = L+1; 
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dcwonvert: =true; 
end 

else begin 

convert [L) : = 0; 

L ; = L+1; 
end; 
end; 

L : = 0; 

Wbite(printer,Chr(27),*G’>2; 4); 
WriteCprinter.chKBinToDec)); 
y ! = y+1; 

Write(prmter,<airCBmToDec)); 
y s = y*i; 
end; 

WritelnCprinter); 
x:=x+8; 
y : = 0; 

Until Cx > 719); 
end; 


BEGIN { main pipgram } 

Reset Cprinter,'-slot2dr«n2-Tid<^ 

QBIhHC^'^eapBuf, cheapBuf [ 10000 ], KHeepFull); { Mvtst do this onoe «t beginning } 
OpenPortCernyPart); 

<aiprect(theP<*l^,portbits.boiunds); 

FillRectCthePiort^.portRect,Vi«hite); C Paint viihite background ) 

DrawStuff; 

PrintScreen; 

GloseCprinter); 

END, 
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Pktigram CHRSamnples: 

{Inducted are sarr^les of how to print (to the default 8t to a specific port). 

How to convert strings to numbers} 

Type 

STR30 = string [30]; 

var integr: integer; 
realno: real; 

Procedure Default; 

{This prints to the default printer) 

var printer : text; 

Begin 

Rewrite(printer,’-printer'); {Open the printer with the logical device name '-printer’} 
VfTitelnCpr inter,’ This will print on the default printer’); 

Writeln(printer.chr(27),chr(110).’This will be extended if the default is a DMP’); 

Close (printer); 
end; 


Procedure Specific; 

{this prints to a printer in a specific port - in this case a dwp in serial B} 

Var printer ; text; 

Begin 

Rewrite(printer,’-rs232ifcr-xyz’); {This opens the printer with the path nsune 
’-rs232b-xyz% a dummy file} 

Writeln(printer,’This will print cat the printer attached to serial B’); 
Close(pr inter); 
end; 


Function Str_to_Integer(str: STR30): Integer; 

{This function converts strings to numbers - integer} 

var nuirtoer : integer; 

Len: integer; 

i: integr; {Length of the string) 
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begin 

len : = length (str); 
nurrber : = 0; 

tar i : = 1 to len do nurrJber : = number *10 + (CDrd(str 
Str_to_Integer ; = number; 
end; 


Function Str_to_IlealCstr; STR30): real; 

{This function converts strings to numbers - real - assumes there are no commas} 

var number : real; 

Len: integer; 

i; integer; {Length of the string} 

Decimal: integer; {position of the Decimal} 

begin 

while Clength(str) >0} and (str{length(str)} = ' ') do delete (str, lengthCstr), 1); {deletes 
trailing blanks} 
len : = length (str); 
decimal : = pos(’.’,str); 
number : = 0; 
for i : = 1 to len do begin 

while i< >decimal do number : = number *10 + (Clrd(str[il)-48); 
end; 

number : - number*pwroften(decimal); 

Str_to_Real : = number; 
end; 

Begin 

Default; 

Specific; 

integr := Str_to_IntegerC2344^’); 

Wiriteln(integr); 

Realno : * Str_to_RealC2345.456’); 

Writeln(realno); 

EtkI. 
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Brogram SanqplesZ; 

{Induded are exarr^les of how to convert numbers to strings) 
Type 

Str30 = sftringllWl; 
maxstring = stringl255l; 


Var intgr : Longint; 
r^ealno : real; 
intstring : maxstring; 

Prooe«jture Int_To_StrC&rtnuTtber : longint); 

Var str.tempstr : maxstrmg; 
temp : integer; 

Begin 

str : = ’ {Assigning a null dnr doesn’t make the length of the string 0} 

deleteCstr,!,!); 

Tempstr : = ' 

vbile intnumberXO do begin 
temp : = intnumber mod 10; 
tenpstr[lj : = chr(temp+48); 
insertCtempstr.str.l); 
intnumber : = intnumber div 10; 

end; 

intstr : = str; 

end; 


Begin 
intgr : = 

va'itelnC’Integer is: ',intgr); 
Int_To_StrCintgr); 
writelnC’String is; ’,intstring); 
end. 
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{gets charekcters ftxxn the keyboard ax¥3 displays them} 


Program GetChars; 

USES 

{$u-> 

{$U QC/QuickDraw } QuickDraw, 
{$U QD/ODSupport } QDeupport, 
{$U QlVHardware } Kauxiware; 
{$U+) 


Type Setofchar = set of char; 
Maxstring = string [255]; 
STR30 = string[30); 

STR50 = string[50j; 


Var cmd ; 
Humber : 
Thing : 
event : 


char; 

integer; 

MaxString; 

keyevent; 


heapBuf : ARRAY [0..10000] OF INTEGER; 
myPort : GrafBort; 

tenpRect : Red; 


FUNCTION HeapPwQlChz: QDPtr; bytesNeeded: INTEGER): INTEGER; 
{ This function will be called if the heaf^one runs out d space > 
BEGIN 

WRITELNCThe heap is full. The program is going to die! ’)» 

Halt; 

END; 


Procedure CursrCvar key: boolean); {Cursor} 
var i J : integer; 

curs : red; 

shift : point; 

base : point; 

begin 

getpenCbakse); 

Curs.topleft : = bas^; 
shift. V : = 1; 
shift.h := 8; 

AcJdPt(base,shift); 
curs.botri^t := shift; 

PaintRect(curs); 

i:=0; 
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repeat 
i : * i + 1; 

key : = Keybdevent(trne, false, event); 
until (i = 2000) or Ckey); 
i : = 0; 

EraseRectCcurs); 
if not key then repeat 
i + 

key ; = Keybcievent(true, false, event); 
until Ci = 2000) or Ckey); 

end; 


Punctkan GetCharCokset: SetofChar) : char; 

Var ch: char; 

good: Boolean; 
state: penstate; 

Key : boolean; 

Begin 

ch:*' 

Good : = Eatlse; 

Repeat 
Key ; = false; 

Repeat curaa*Ckey) until key; 
ch : == Event.asGii; 
good : = <d\ in okset; 
if not good then 
write CchrC?)); 
until good; 

GetCa^ : = ch; 

End; 


Procedure EraserCwidth: integer); {Backspaces characters on the screen) 
Begin 

PensizeC3,15); 

PenPatCwhite); 

moveCO,-13); 

ShowPen; 

Line(-width,0); 

HidePen; 

MoveC0,13); 
penpat {black); 
pensizeCl,!): 
end; 
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Ptx>cedure GetStringCm&xlen: integer); 


var si: string [Ij; 

stemp: maxstring; 

CfKset: Setofchan 

Vidth,x: integer; 
Space: integer; 

I: integer; 


begin 

thing : = ' 

OKset := (’ ’..'z’]; 

Space: =-CCharWidthC’ ’)); 

Width ; = 0; 
si: »’ 
stemp:*’ 

delete(stemp,l,l); 

i: =1; 

repeat 

if ((length(stenp) = 0) or Ci = 1)) then 
sl[l] : = getcharCokset + tchK13)l) 
else 

if i = maxlen+1 then 
sl[l) : = fetcharCCchr(13), chr(8)]) 
else 

si [1 1 ; = getchaKokset+ [chKl3),chK8) } ); 

If sl[l] in okset then 
Begin 

IkawstringCsl); 
sterrp : * concatCstemp.sl); 
i; =i+i; 
end 
else 

if CCslilJ = chrC8)) and Ci < > l))then 
begin 
i: =i-l; 

width: =CharWidthCstemp [i ) ); 
DeleteCstemp.i,!); 

EraserCwidth); 

end; 

Until sl[l] = chKl3); 

If length(stemp)< >0 then thing: =sterrp 
else CrawStringCstemp); 
end; {GetString} 
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Procedure Text; 


Vaar nane : str30; 

Street,state : strSO; 


Begin 

teiT¥>R«ct : = thePcirt''.portIlect; 

ClipRect(tempRect); 

EraseRoundIlectCiempRect,30,290); 

TextFont(4); 

TextRK»C[bold]); 

MoveTo(150,100); DrawStringC’&iter Name: ’)» 
TextFaceCll); 

Getstring(30); 
name : = thing; 

TextFace([bold]); 

MoveToC150,120); Drav«tringC’Enter Street Address: 

TextFaoe([]); 

getstringCSO); 

Street ; = thing; 

TextFaoeC I bold } ); 

MaveTo(150,140); DrawStringC’Enter CHy 8e State: 
TextFaceCll); 

GetStringC50); 

State : = thing; 

TextFaoeC {boldl ); 

MoveToC150,300); DrawStringC’End of demonstration.^; 
end; 


Begin {** * ******* * Main Program »*»»*»»»***} 

{*** QuickDraw **«*} 

QDInitCflheapBuf, cheapBuff 10000], tSieapFuU); {Initializes the heap) 
C3penPcrtC®miyPart); (opens the GrafPort) 

EraseRectCthePort'^.pca'tRect); 

FillRectCthePQrt''.portIlect, black); (Paint blaick background) 

uy stuff «^) 

Number ; = 0; 
text; 
end. 


45 



Macintxjsh Errors 


Qeneral System Enors 
0 No Errors 

-1 Queue element not found during deletion 

-2 Invalid queue element 

-3 Core routine number out of range 

-4 Unlmplemented core routine 

I/O System Errors 

-17 Control error 

-18 Status error 

-19 Read error 

-20 Write error 

-21 Bad unit enor 

-22 Unit empty enor 

-23 Op^ error 

-24 Close enor 

-25 Tried to rerrwve an open driver 

-26 Driver install couldnt find driver in resources 

-27 I/O call aborted by KILLIO 

-28 Coulcrj*t read/write/control/status becajse driver not open 

File System Errors 

-33 Directory full 

-34 Disk full 

-35 No su(^ volume 

-36 I/O error 

-37 There may be no bad names In the final system 

-38 File not open 

-39 End of file 

-40 Tried to position to before start of file 

-41 Memory full (open) or file won't fit Ooal) 

-42 Too many flies open 

-43 File not found 

-45 File Is locked 

-46 Volume Is lodced 

-47 File Is busy (delete) 

-48 Duplicate file name (renane) 

-49 File already open with write permission 

-50 Error In user parameter list 

-51 Refnuh enor 

-52 Get file position enor 

-53 Volume not on line error (was ejected) 

-54 Permissions error (on file open) 

-55 Drive volume already on-line at Mountvol 

-56 No such drive (tried to mount a bad drive number) 

-57 Not a Mac diskette (signature bytes are wrong) 

-58 VOlune In qu^tion belongs to an external fs 

-59 File system deep s— t enor; during rename the old entry was deleted 
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-60 

-61 


but could not be restored 
Bad master directory block 
Write permissions error 


Disk, Serlaii Ports, Clock Specific Errors 


-64 

-65 

-66 

-67 

-68 

-69 

-70 

-71 

-72 

-73 

-74 

-75 

-76 

-77 

-78 

-79 

-80 

-81 

-85 

-86 

-87 

-88 

-89 

-90 


Drive not Installed 

ReadAvrIte requested for an off-line drive 

Couln't find 5 nibbles In 200 tries 
couldn't find valid address maik 
Read varlfy compare failed 
Address maik checksum didn't check 
Bad address maik bit slip nibbles 
Couldn't find a data mark header 
Bad data maik checksum 
Bad data mark bit slip nibbles 
Write underrun occured 

Step handshake failed 

Track 0 detect doesn't change 

Unable to Initialize IWM 

Tried to read second side on a one sided drive 

unable to correctly adjust disk speed 

Track number wrong on address mark 

Sector nunft>er never found on a track 

Unsble to read same clock value twice 
Time written did not varlfy 
Parameter ram written dlcn'i read varlfy 
initutil found the parameter ram uninitialized 

see receiver error (framing, parity, OR) 

Break received (SCC) 


Storage Allocator Errors (htemoiy Management) 


-108 

-109 

-111 

-112 

-110 

-113 

-114 

-115 

-116 

-193 

-194 

-195 

-196 

-197 


Not enou^ room in heap zone 
Handle was nil In handle zone or other 
WhIchZone failed (applied to free block) 

Trying to purge a locked or non-purgable block 

Address was odd or out of range 

Address In zone check failed 

Pointer check failed 

Block check failed 

Size check failed 

Resource file not found 

AddResource failed 

AddReference failed 

RntveResource failed 

Rm\«Reference failed 


Scrap Manager Errors 
-100 NO scr^ exists error 


-102 


No object of that type In scrap 


45 



/plication Enors 

Errors -1024 to -4095 are reserved for use by the current application 

Alert ID Deflrtitions 

32767 General system error 

1 Bus error 

2 Address error 

3 111^1 instruction error 

4 Zero divide error 

5 Check trap enor 

6 Overflow trap error 

7 Privelege violation enor 

8 Trace mode error 

9 Line 1010 trap error 

10 Line 1111 trap error 

11 Miscellaneous hardware exception error 

12 unlmplemented core routine error 

13 Uninstalled Interrupt error 

14 I/O core error 

15 Segnent loader error 

16 Floating point enor 

17 Package 0 not present 

18 Package l not present 

19 Package 2 not presait 

20 Package 3 not present 

21 Package 4 not present 

22 Package 5 not presort 

23 Package 6 not present 

24 Package 7 not present 

25 Out of memory! 

26 Cant laun(^ file 

28 Stack has moved into application he^ 

27 File system map has been trashal 

30 RecMest user to reinsert off-line volume 

31 Not tne disk I wanted 


Trouble Allocator Trouble Codes 


32 

MemTrbBase 

MemTrbBase-^l 

M«nTrbBase+2 

MemTrbBase'^3 

MemTrbBase-^7 

MemTrbease-»8 

MemTrbBase-»9 

MemTrbBase-»10 

MemTrbBase+ii 

MemTrb6ase+l2 

MemTrbBase-^13 

MemTrbBase-»l4 

MemTrbBase-^15 


Memory Manager trouble code base 
Set logical size enor 
Adjust free enor 
Adjust counters enor 
Make block free enor 
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MemTrtJBase^ie 

MemTrt)Base*l7 

MemTit»ase+l8 

MemTit)Base+l9 

MemTit)Base+20 

MemTrt>Base+2i 

Some Miscellaneous Result Codes 

1 Event not enabled at PostEvent 

-1 No event available (GetOSEvent OSEventAvall) 
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